home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
By Popular Request 2.0
/
By Popular Request 2.0 (Arsenal Computer).ISO
/
amiga_1
/
aminup.lha
/
AmInUp.doc
< prev
Wrap
Text File
|
1995-05-02
|
5KB
|
114 lines
===========================================================
== ==
== A m I n U p v1.0 ==
== ==
== (Aminet Indexes Updating utility) ==
== ==
== FREEWARE by Emanuele Bolognesi 1995 ==
== ==
===========================================================
AmInUp is FREEWARE, but you may not copy and/or distribute this program
without the accompanying documentation unless you get permission from the
author to do so.
This product is sold "as is" without representation or warranty of
any kind, either expressed or implied. The user assumes all risks and
responsibilities related to its use.
INTRODUCTION
This utility is very useful if you are used to print your Aminet indexes.
Let's suppose you have downloaded a big INDEX (e.g. util/INDEX or game/INDEX)
and you have printed it with your fantastic printer. Then, 1/2/3... weeks
later, you download the same index another time. It has, obviously, changed
and you have two choices: reprint it completely, spending precious ink and
paper, or..... use AmInUp updating the old print!
USAGE: AmInUp <newindex> <oldindex> [SAMEDIRS] [NOTITLE]
AmInUp extracts from <newindex> all the lines not present in <oldindex>.
So, if you print these lines, you can add some pages to the old index,
updating it. Unfortunately, the print is no more in alphabetic order, but you
have spared time and expense.
Remember: AmInUp works with Aminet indexes only!
NOTE FOR NON-GURUS:
AmInUp must be used from the CLI (Shell).
Output goes to the StandardOutput (i.e. the CLI window) but you can redirect
it by adding a ">" at the end of the command line.
"AmInUp NewIndex OldIndex >PRT:" --> extracted lines will be printed.
"AmInUp NewIndex OldIndex >myfile" --> a new file "myfile", containing the
extracted lines, will be created.
OPTIONS:
1- If you specify "SAMEDIRS", AmInUp does not extract lines containing
directories not present in <oldindex>.
Ex. If your old index is "game/INDEX" and it lists these directories:
game/2play, game/demo, game/gag, game/hint etc... and your new "game/INDEX"
contains these directories: game/2play, game/board, game/demo etc.., AmInUp
does not extract lines regarding "game/board".
The most useful application of this option is to allow you to update an
index using a more general index.
Ex. If you have printed "game/shoot/INDEX" and then you have downloaded a
more recent game/INDEX you can see all the new uploads to game/shoot with:
AmInUp 'game_INDEX' 'game_shoot_INDEX' SAMEDIRS
Only lines containing the directory "game/shoot" will be extracted from
'game_INDEX', and only those not present in your old 'game_shoot_INDEX'.
2- Normally AmInUp writes a little header at the beginning of the new index
it produces; if you specify 'NOTITLE', this header will be omitted.
As you know, every Aminet INDEX has 2 lines at the beginning:
" | Contents of the directory 'DIRECTORY' : 'directory description'
|--------------------------------------------------------------------- "
AmInUp writes these lines (if you don't specify 'NOTITLE'):
" | UpDate of the directory 'DIRECTORY' Date:
|--------------------------------------------------------------------- "
The string 'DIRECTORY' is taken from <oldindex> (from its header).
The date is not written, since AmInUp couldn't know when you have down-
loaded <newindex>. If you print directly the update you can add the date by
hand, or if you redirect the output to a file, you can add it with a text
editor.
IMPORTANT: AmInUp checks the presence of the Aminet header (both 2 lines) at
the beginning of <newindex> and <oldindex>, if it can't find it, an error
will be reported: "Files are not Aminet indexes". The header written by
AmInUp ( "UpDate of ...." ) goes well too. So AmInUp can work with files
generated by itself, if you don't specify NOTITLE.
This is a simple program, but very useful (at least for me).
If you find some bugs (impossible...) or if you have some suggestions,
please contact me by e-mail.
Bye!
=== AUTHOR: =====================================
EMANUELE BOLOGNESI
address: Via Marzocco 45
57011 Castelnuovo M. (LI)
ITALY
e-mail: bolognes@cli.di.unipi.it
=================================================